🎉 Welcome to CausalMap!!

📺 If you like learning through video, there are some short Causal Map videos to get you started: here. Or keep reading this Guide!

Try this: code the short example project:#

• We've created a practice project for you called example-short-[your-username]. This gives you your own copy of our tutorial project to experiment with freely. You should see it in the Project Dropdown Menu at top left of the app.
• Select source 1 in the source selector. This will display the text from this source. This source is already partially coded for you.
• Practice highlighting causal claims in the Source Text Viewer to create links in the Create Links tab.
• View, edit or delete existing links in the Source Text Viewer in the Create Links tab by clicking on the highlighted sections of text or on the corresponding links in the Map.
• Watch the causal relationships grow in the Map panel

Try this: view some examples of what you can do.#

These examples are views of a real-life, anonymised QuIP project in the field of international development.

• Main factors map.
• Main factors table.
• Consequences of increased knowledge map.

You can find them in the Project Dropdown Menu.

Get help / read the documentation#

The documentation you are reading now is embedded in the app via the Help System and is also available as a standalone Guide.

Each section corresponds to a different part of the interface.

Within the app, you can:

• click the blue help buttons to find out more about the different parts of the app
• click the [Help](#help-system) button at top right to open and search the help documentation.

But what even is causal mapping?#

This Guide is all about how to use the app. For example it tells you how to use the different filters. If you want to find out more about the ideas behind those filters, we have a new "Ideas Garden" with a more discursive look at the theory and everything that surrounds causal mapping. It's a work in progress but we are adding material every day, please bear with us.

Someone shared their work with you?#

If they have to a particular map (or table), click the link and you will be automatically taken to view the corresponding map (or table), providing they have given you the correct permissions.

Alternatively if they have just asked you to log in at the app to explore a file name, say "project-x", log in and click on the dropdown list on the left-hand side and click on project-x to load it. If you can't find that file name, it means they haven't correctly shared it with the email address you logged in with.